home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 351-375 / 367 / scm / scm&l.doc < prev    next >
Text File  |  1995-03-14  |  10KB  |  249 lines
  1.                                                     Screen  Color Modifier
  2.  
  3.  
  4.                        SCREEN      COLOR      MODIFIER
  5.                                by Jean-Marc  NOGIER
  6.                                    (release 1.0)
  7.  
  8.          (First, I'd like to apologize for my poor english.)
  9.  
  10.          This utility is public domain freeware. Everybody that could find
  11.       an interest in this program  can copy it and use it freely.
  12.  
  13.  
  14.          SCM stands  for "Screen  Color Modifier". It allows you to change
  15.       the  colors of  any (didn't check  fully for HAM  screen,  and can't
  16.       check for  halfbrite screen) opened screen under Intuition.
  17.          I created it to be able to change the  colors of program that  do
  18.       not support  user color modification (e.g. Sculpt3D).
  19.          Then the modified colors can be saved to  disk to be used later.
  20.  
  21.          SCL stands for  "Screen color Loader". It allows you to load some
  22.       colors to a specified screen from  a file saved under SCM.
  23.          SCL  is smaller  and  uses  less  memory   than  SCM.  I keep  it
  24.       separated  from  SCM for  these reasons, and also because I was  not
  25.  
  26.       able to use overlays under  AmigaDOS.
  27.          SCL waits  for  the specified screen to  be opened, then  changes
  28.       its colors, and exits.
  29.  
  30.          The procedure to  use SCM and SCL  is:
  31.          - load the application the screen colors have to be modified,
  32.          - load SCM from  the CLI or the  WorkBench,
  33.          - modify the colors under  SCM,
  34.          - save color modifications to a file.
  35.  
  36.          At a later use:
  37.          - load SCL from  the CLI specifying the screen,
  38.  
  39.          - load the application,
  40.          - look at the screen colors being modified.
  41.  
  42.          SCM  and  SCL were   written  on  a NTSC  Amiga  1000, using  the
  43.       Lattice C compiler (release 5.04), and PowerWindows  (release 2.5).
  44.  
  45.          I didn't check the  PD  libraries to see if a similar program  is
  46.       already available (excepted the  Palette program  on  the Workbench
  47.       disk), but  anyway  if there  is enough people interested  in SCM  &
  48.       SCL, I may update  them later.
  49.  
  50.          I know the  code size is too big (I'm not a professional), that I
  51.  
  52.       did not  check all possibilities (but my time is limited). So if you
  53.       discover  a bug  and would  like it to be fixed, you  can mail me  a
  54.       letter  at  the following address,  I'll try to  find some  time  to
  55.       answer  you.
  56.  
  57.       address: Jean-Marc  NOGIER        in FRANCE: BAL JMN  on Sgt FLAM
  58.                30 Bd. de La Paix                   (1 39 55 84  59)
  59.                92400  COURBEVOIE
  60.                           FRANCE
  61.  
  62.  
  63.         JMN                         page 1                    20-Apr-90                                                     Screen  Color Modifier
  64.  
  65.  
  66.  
  67.                              SCM     description
  68.  
  69.          To run  SCM click on its icon, or type "SCM"  at the  CLI prompt.
  70.       A  new   screen  which  name  is  "Screen Color  Modifier"  is being
  71.       displayed  at  the  bottom   of  the  current  screen  (usually  the
  72.       Workbench  screen). It  is lo-res and features  a title bar to  drag
  73.       it  and 2  depth  arrangement  gadgets. The  window  opened  in this
  74.       screen   is  called  "Screen  Color  Modifier"  (well  that's   free
  75.       advertisement  space)  and features  2  to 32  color gadgets on  the
  76.       left, the  color  currently selected, 3  RGB  sliders to modify  the
  77.       selected color, a gadget called "OK" to save your  changes, a gadget
  78.       called "NO" to  undo your  modifications, and 2 arrows  to allow you
  79.  
  80.       to find the  screen the colors of which you want  to modify.
  81.  
  82.          First, click once on the down  arrow  to display the next  screen
  83.       name.  If no other  screen than  the Workbench  is opened, then  you
  84.       should see  SCM  screen  name. Otherwise  the  next  screen name  in
  85.       Intuition list is displayed in the string  gadget. You  can click on
  86.       the down  arrow  until you reach the last screen.
  87.          Now  click on the  upper  arrow  to  display the previous  screen
  88.       name  and continue until you reach the first screen name.
  89.          Since screens are linked by Intuition if you change screen display
  90.       order  when   using SCM,  you  may  have  to  search forward,   then
  91.       backward  until you find that  screen name.  Notice that  clicking on
  92.  
  93.       the  arrow  gadget display the screen name,  but doesn't display the
  94.       screen.  You  need  to  find  the  screen  using depth  arrangement
  95.       gadgets if you want  to look at the  modifications you've made.
  96.  
  97.          Click on the gadget colors (from  2 to 32 gadgets)  to select the
  98.       color you  want  to modify. The color selected appears  in the large
  99.       rectangle between  the color gadget and the  RGB sliders.
  100.          Notice that when  you select another  screen the number  of color
  101.       gadgets is adjusted to the  screen depth.
  102.  
  103.          Modify the  selected color using the RGB sliders as you  would do
  104.       in Preferences.  The  amount  of red,  green and  blue are  displayed
  105.  
  106.       right to the  corresponding sliders (from 0 to 15).
  107.  
  108.          The changes  you've just made may  be canceled by clicking on the
  109.       NO  gadget.
  110.          Otherwise you can save  to a file the modification you've made by
  111.       clicking on the  OK  gadget. A  file requester  opens and  you must
  112.       select  a drawer   and  a file name,  by  typing  the names  in  the
  113.       corresponding string  gadgets. As an alternative you can  select the
  114.       drawer  by  clicking on one of  the 5  gadgets on the  right of  the
  115.       requester.  When  the drawer   is selected, the file names  of  that
  116.       drawer  are  displayed sorted by alphabetical order, followed by the
  117.       sub-directories  of that  drawer  if  any. Files and sub-directories
  118.  
  119.       can  be selected by clicking on their respective names. If you want
  120.       to go  backward in the directory tree  click on the "/" gadget.
  121.          Modifications are saved  under the  specified file name when  you
  122.       click on  the  OK  gadget  of  the  file requester.  You can  cancel
  123.       anytime by  pressing the Cancel gadget.
  124.  
  125.         JMN                         page 2                     20-Apr-90                                                     Screen  Color Modifier
  126.  
  127.          Click on the windowclose gadget to quit SCM.
  128.  
  129.          There is also a menu featuring 4  items:
  130.  
  131.  
  132.          -  Load: allows  you  to  replace the  colors  of  the  currently
  133.       selected screen with  the colors contained in a file previously saved
  134.       under SCM.
  135.          If the number  of  colors in the file is less than the number  of
  136.       colors  of  the  current   screen, only  the  first  colors  of  the
  137.       current  screen are replaced.
  138.  
  139.          -  Save: save  your  modifications to  a  file under  the  latest
  140.       specified file name.
  141.  
  142.          - Save as: same action as clicking on the OK gadget.
  143.  
  144.  
  145.          - Quit: same action as clicking on the windowclose gadget.
  146.  
  147.  
  148.          Note: do  not try  to modify  the colors  of a screen  under SCM
  149.       after  this screen  has been closed, or  you may  crash the  system.
  150.       This  is because  SCM  doesn't know  about  closed screen  until you
  151.       select a new  screen with the gadget  arrows.
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.         JMN                         page 3                     20-Apr-90                                                     Screen  Color Modifier
  188.  
  189.  
  190.                                SCL    description
  191.  
  192.          To run SCL type  at the CLI prompt:
  193.  
  194.                SCL -c<file name>  [-t<timeout>] [-p<period>]
  195.  
  196.           The  filename is mandatory. it  can be created  using the save
  197.      option of SCM.
  198.  
  199.  
  200.           The  timeout is by  default quite  a long time  (more  than 68
  201.      years should be  above Amiga  MTBF), but can  be changed to  a value
  202.      you specify in seconds.
  203.  
  204.           The  period (by  default 5  seconds) is  the interval  of time
  205.      between  2 screen checking. Specify it in seconds.
  206.  
  207.           SCL  tries to  change  the  color of  the  screen  whose  name
  208.      appears  in the  file name  specified in the  command   line. If the
  209.      screen  is not yet  opened, SCL  waits for  it to open, changes  its
  210.      colors, and then exits. The new  colors are read  from  a file which
  211.  
  212.      can be created  using the screen color modifier utility (SCM).
  213.           If the  screen is not  opened, SCL goes  to sleep for  a period
  214.      of  time  you can  specify  with the  -p  option. It defaults  to  5
  215.      seconds. After  this period of time, SCL checks  again if the screen
  216.      is opened and so on.
  217.           The  time  SCL  wait  for  the  screen  to  be  opened  can  be
  218.      specified with the -t option.
  219.  
  220.           An example to  use it (replace Sculpt3D with your choice):
  221.  
  222.           - load Sculpt3D,
  223.           - load SCM,
  224.  
  225.           - find Sculpt3D screen,
  226.           - modify the  colors as you like,
  227.           - save the  modification to a file named: "dh0:Sculpt.scm",
  228.           - create  a batch file called Sculpt3D_my_colors, with 2 lines:
  229.                - Run SCL  -cdh0:Sculpt.scm
  230.                - Run Sculpt3D
  231.           - type Execute  Sculpt3D_my_colors,
  232.           - watch  the colors of the Sculpt3D screen  being changed.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.         JMN                         page 4                     20-Apr-90